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The TRS-80 Cross Reference Utility program is 
designed to build a cross reference table for any 
BASIC program. The programmer has a choice of 
listing by Variable, Reserved Word, or Line 
Number. The computer will print these elements 
followed by the line number in which they appear. 
Both Tape and Disk versions are included. 

Required Equipment: 
16K Level H TRS-80 
Printer 

Optional Equipment for Transfer to Disk: 
Expansion Interface 
Disk Drive(s) 
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Introduction 



Introduction 

The TRS-80 Cross Reference Utility program is designed to build a cross 
reference table for any BASIC program. The programmer has a choice 
of listing by Variable, Reserved Word, and/ or Line Number. The computer 
will print these elements followed by the line number on which they 
will appear. The programmer can use this information to quickly locate 
subroutines or to identify variables. 

There are two versions of the program in this package. The Tape version 
is for the normal Level II TRS-80; the Disk version is required when using 
TRS-80 mini Disks and TRSDOS. 



Features and Notes on Program Operation 

1. Any combination of options may be selected by replying H or H 
to questions. 

2. The data is displayed on the screen and can also be printed. 

3. If you are not using the printer, the screen will show: 

ENTER TO CONTINUE. Press 1 ENTER 1 when you are ready to start 
a listing. 

4. You have a choice of categories to cross reference; line numbers, 
variable names, and reserved words (IF, GOSUB, etc.). 

5. Pressing the I SHIFT I and H keys simultaneously will halt the listing 
on the screen. Pressing 1 ENTER I will terminate the rest of the list. 
Pressing any other key will resume the listing. 

6. When the listing is done, you have an option to go through the 
program again. 

7. You can rerun the program without reloading. 

t 8. Disk version will print CAN'T READ if file can not be opened and 

WRONG TYPE FILE if non-BASIC file is specified. 
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Loading the Tape Version 



How to Load the Tape Version of Cross Reference 

Follow these steps: 

1. Turn on the TRS-80 video screen. 

2. Turn on the TRS-80 keyboard. 

The screen will show: You type: 

MEMORY SIZE? Press IENTERI 

READY>_ 

3. Insert the Cross Reference tape (Tape Version) into the 
cassette recorder. 

4. Rewind the tape. 

5. Press the "PLAY" button. 

6. Type SI H SUB E 01 and press I ENTER] 

The screen will show: You type: 

*?_ KlHBBffl and press E NTER] 

*?_ and press 1 ENTER I 

The program will immediately begin. Turn to the middle of page 7. 
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Transferring to Disk 
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Transferrins :c Disk \Fzt Disk Users Only) 

Use the TAPEDISK utility to transfer Cross Reference from Tape to Disk. 
Detailed instructions for using TAPEDISK are on pages 5-8 and 5-7 of 
your TRSDOS Reference Manual. 

Follow these steps: 

1 . Put the Cross Reference tape (Disk Version) in the recorder and rewind 
the tape. 

2. Set the volume of the recorder between 4 and 8. 

3. Press the "PLAY" button on the recorder. 



The screen will show: 
DOS READY 



(Program will 
load from Tape) 



(Program will be 
written to Disk) 



DOS READY 



You type: 

fflHHBHCDKH and press FElTERf 

S3 and press !MMM 



m m IK* in u a b a .'. i>: r r-j ■ m m r-j r-.j ■ m ■: u m ■ 14 m am 



and press | ENTER] 
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Running tie Program 



Bunning tie Program 

Diskettes can be damaged through contact with magnetic fields, 
mishandling, etc. To insure against loss of your program, before you begin 
running Cross Reference, you should make a copy of your diskette and 
keep the original in a safe place. See Appendix A for detailed Backup 
instructions. 

Follow these steps in the exact order: 

1. Turn on everything, except the TRS-80 keyboard. 

2. Insert the Backup copy of the Cross Reference diskette (notch up, 
label facing to the right) in Drive and close the door. Make sure the 
notch is not covered with a piece of tape. 

3. Turn on the TRS-80 keyboard. 

The screen will show: You type: 

DOS READY BHBB and press I ENTER I 

The screen will show the following options: 



PRINTER? — You may answer either 0or |. H will cause data to be 
displayed on the screen. H will cause the data to be printed. 



Note: If you press H but do not have a printer, the program will lock. 
Push the Reset button to start over. 



LINE-NUMBERS? — H will cross reference line numbers (statement 
numbers) when they follow GOTO , GOSUB , ELSE , or RESUME. 



VARIABLES? — H will cross reference variable names. 

RESERVED WORDS? — H will cross reference all BASIC reserved words. 



FROM DISK? — (Disk version only) H will load BASIC programs from 
Disk. H will load programs from tape. 



Answer H for Yes or H for £Jo to each question. 



the Progr"«: '-.ontinued) 
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EXAMPLE: 

The screen will show: You type: 

PRINTER? m . 

LINE-NUMBERS? H 

VARIABLES? B 

RESERVED WORDS? H 

FROM DISK? H 

If you are using a cassette tape, the screen will show: 

READY CASSETTE 

Put the tape, containing the BASIC program, in the recorder and press 
the "PLAY" key. Then press flNTERl . 

If you are using a Disk, the screen will show: 

ENTER F1LESPEC 

Type the name of the disk file, without quotes, and press I ENTER I . 

If the program cannot be found or read, the message, 

CAN'T READ! TRY AGAIN will appear. Press f ENTER 1 to get back 

to FROM DISK? orpress ISHIFTJ and B.then 1. ENTER] to get back to the 

beginning. If the file is not a proper basic program, WRONG TYPE FILE 

will appear. 

If you are not using the printer, ENTER TO CONTINUE will appear. 
Press I ENTEBl and the listing will begin on the screen. You can stop the 
listing by holding down the FSHtFTl key, then pressing the H symbol. 

When the listing is done the screen will show: 

END OF LIST - RESTART? 

H will terminate the program. will let you start over. If you want to 
start over, the screen will show: 

SAME PROGRAM? 

H will allow you to make another list without reloading the program, 
jp will cause the program to completely start over at the beginning. 

Note: If the program will fit in memory when loaded by BASIC, it will fit 
when loaded by this program. (Even larger programs will fit sometimes.) 
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How to Backup Your Program Diskette 

Use this procedure EXACTLY: 

1. Turn on everything except the TRS -80 keyboard. If this is the first time 
you've ever used the Radio Shack Disk System, refer to the 

Disk Operating System Manual for detailed instructions. 

2. Insert a new, blank diskette in Drive 1 (farthest from the Interface) 
with the diskette notch up, label to the right. 

3. Close the Drive 1 door. 

4. Insert the Program diskette in Drive with the notch up, label facing 
right, and close the door. (Drive is the first drive connected to 

the interface.) 

5. Turn on the TRS-80 Keyboard. (The switch on the right rear apron.) 
The screen will slow: You type: 

DOS READY BBBBBB and press HmEE 

SOURCE DRIVE NUMBER? M and press fENTERl 

DESTINATION DRIVE NUMBER? 0] and press fENTERl 

BACKUP DATE (MM/DD/YY)? BffiBBfflBBB DMffiS 

HIT 'ENTER' TO CONTINUE (Example for January 1, 1980) 

STOP — Don't press anything!!! 

Now we can check to see if the "Backup" procedure was successful: 

1. Remove the Program diskette from. Drive 0. 

2. Take the Backup diskette out of Drive 1. Place the Backup copy 
in Drive and close the door, 

3. Now you can press [ENTER] . If the screen shows: DOS READY, your 
Backup was successful. 

If something went wrong, go back to step 1. 
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important Information for Cassette Users 



Using Your Cassette Deck 

Many factors affect the performance of a cassette system. The most 
significant one is volume. Too low a volume may cause some of the 
information to be missed. Too high a volume may cause distortion and result 
in the transfer of background noise as valid information. 

Three different cassette models have been supplied with the TRS-80 system - 
the CTR-40, CTR-41 and CTR-80. Each model has its own loading 
characteristics. The table below gives suggested volume ranges for each of the 
CTR models. 

Notice that volume ranges for LEVEL I and LEVEL li are different. This is 
because the LEVEL II data transfer rate is faster (500 baud vs. 250 baud). Also, 
notice that pre-recorded Radio Shack programs need a slightly higher volume 
setting than that required by your own GSAVEd tapes. The prerecorded tapes 
are produced with high-speed audio equipment at a slightly lower level than 
the CSAVE process provides. 



RECORDER 


USER-GENERATED TAPES 


PRE-RECORDED RADIO SHACK TAPES 


MODEL 


LEVEL I 


LEVEL II 


LEVEL i 


LEVEL li 


CTR-40 


YELLOW LINE 


RED LINE 


YELLOW LINE 


RED LINE 


CTR-41 


6 — 8 


4 — 6 


6V 2 — 8V2 


5 — 7 


CTR-80 


4V 2 — 6 1 /2 


3 — 5 


5% — Vh 


2Vz — 5 



Recommended Volume Settings for RADIO SHACK Cassette Decks 

(With CTR-40 and CTR-80, to increase volume, turn the control to the left. 
With CTR-41, turn control to the right.) 

When information is being loaded from the cassette tape, two asterisks will 
appear on the screen. The one on the right will flash on or off each time a new 
line of program is read in. If the asterisks do not appear, or the one on 

the right does not flash, then the volume setting is probably too low. If the 
asterisks appear but one is not flashing, try increasing the volume setting. Use 
the reset button to stop the cassette and return control to you if loading 
problems occur. (Asterisks do not blink when loading data from cassette.) 

Radio Shack programs are recorded at least twice on each tape (usually once 
on each side). You should do the same when you record programs on tape. 
This will give you a back-up if one does not load properly or if it becomes 
damaged. 

Important Note: The CTR-41 requires that you keep the supplied "dummy 
plug" in the MIC jack at all times. However, the CTR-40 and the CTR-80 should 
never be used with the "dummy plug." 



LEVEL I 

Sometimes you will get an error message during an attempted cload. This 
means that some information was lost or garbled. Adjust the volume level 
slightly and try again. 

LEVEL II 

In case of an error message, proceed as above. In level ii, there is also a rare 
case in which the program has not loaded correctly even though no error is 
generated. So, after CLOADing a program, be sure to LIST it. If some data was 
garbled, then at some point in the listing, the display will be filled with 
meaningless words and characters. Adjust the volume and try again. 

Hints and Tips 

Computer tapes should be stored in a relatively dust-free area (a cassette case 
is recommended) and protected from high temperatures. Magnetic and 
electrical fields may alter recorded information, so avoid them (i.e. 
household appliances, power sources such as transformers and television 
sets, etc.). 

The cassette deck supplied with TRS-80 is very compatible with the system and 
will perform its duties with great success. To keep the cassette deck in top 
condition and thus minimize your problems, you should periodically perform 
some routine maintenance on it. Dirty heads can cause as much as a 50^'f loss 
in volume. Also, heads become magnetized with use and may cause 
distortion. We recommend that you clean the head, capstan and pinch roller 
after every four hours of operation. Heads on new recorders should always be 
cleaned before use. 

Note: Cassette cleaning and demagnetizing accessories are available from 
your local Radio Shack store. 



IMPORTANT NOTICE 

ALL RADIO SHACK COMPUTER PROGRAMS ARE DISTRIBUTED ON AN 
"AS IS" BASIS WITHOUT WARRANTY. 

Radio Shack shall have no liability or responsibility to customer or any other 
person or entity with respect to any liability, loss or damage caused or alleged to 
be caused directly or indirectly by computer equipment or programs sold by 
Radio Shack, including but not limited to any interruption of service, loss of 
business or anticipatory profits or consequential damages resulting from the use 
or operation of such computer or computer programs. 

NOTE: Good data processing procedure dictates that the user test the program, 
run and test sample sets of data, and run the system in parallel with the 
system previously in use for a period of time adequate to insure that 
results of operation of the computer or program are satisfactory. 
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